home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / daemons / dns / bind-4.9 / bind-4 / usr / man / man7 / hostname.7 next >
Encoding:
Text File  |  1995-08-04  |  5.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. HOSTNAME(7)                                           HOSTNAME(7)
  5.  
  6.  
  7. NNAAMMEE
  8.        hostname - host name resolution description
  9.  
  10. DDEESSCCRRIIPPTTIIOONN
  11.        Hostnames  are  domains.  A domain is a hierarchical, dot-
  12.        separated list of subdomains.  For  example,  the  machine
  13.        _m_o_n_e_t,  in  the _B_e_r_k_e_l_e_y subdomain of the _E_D_U subdomain of
  14.        the Internet Domain Name System would be represented as
  15.             _m_o_n_e_t._B_e_r_k_e_l_e_y._E_D_U
  16.        (with no trailing dot).
  17.  
  18.        Hostnames are often used with network  client  and  server
  19.        programs,  which  must  generally translate the name to an
  20.        address for use.  (This task is usually performed  by  the
  21.        library routine _g_e_t_h_o_s_t_b_y_n_a_m_e(3).)  The default method for
  22.        resolving hostnames by the Internet name  resolver  is  to
  23.        follow  RFC  1535's security recommendations.  Actions can
  24.        be taken by the administrator to override these  recommen-
  25.        dations  and  to have the resolver behave the same as ear-
  26.        lier, non-RFC 1535 resolvers.
  27.  
  28.        The default method (using RFC 1535 guidelines) follows:
  29.  
  30.        If the name consists of a single component, i.e.  contains
  31.        no dot, and if the environment variable ``HOSTALIASES'' is
  32.        set to the name of a file, that file  is  searched  for  a
  33.        string  matching the input hostname.  The file should con-
  34.        sist of lines made up of two strings separated  by  white-
  35.        space,  the  first of which is the hostname alias, and the
  36.        second of which is the complete hostname to be substituted
  37.        for  that  alias.   If  a  case-insensitive match is found
  38.        between the hostname to be resolved and the first field of
  39.        a line in the file, the substituted name is looked up with
  40.        no further processing.
  41.  
  42.        If there is at least one dot in the name, then the name is
  43.        first  tried  as  is.   The  number  of dots to cause this
  44.        action is configurable by setting the threshold using  the
  45.        ``_n_d_o_t_s'' option in _/_e_t_c_/_r_e_s_o_l_v_._c_o_n_f (default: _1).  If the
  46.        name ends with a dot, the trailing dot is removed, and the
  47.        remaining  name is looked up (regardless of the setting of
  48.        the 'ndots' option) and no further processing is done.
  49.  
  50.        If the input name does not end with a trailing dot, it  is
  51.        looked  up  by searching through a list of domains until a
  52.        match is found.  If  neither  the  search  option  in  the
  53.        _/_e_t_c_/_r_e_s_o_l_v_._c_o_n_f  file  or the ``LOCALDOMAIN'' environment
  54.        variable is used, then the search list of domains contains
  55.        only  the  full  domain specified by the domain option (in
  56.        _/_e_t_c_/_r_e_s_o_l_v_._c_o_n_f) or the domain used in the local hostname
  57.        (see  _h_o_s_t_n_a_m_e(1)  and  _r_e_s_o_l_v_e_r(5)).  For example, if the
  58.        ``_d_o_m_a_i_n'' option is set  to  _C_S_._B_e_r_k_e_l_e_y_._E_D_U,  then  only
  59.        CS.Berkeley.EDU will be in the search list and will be the
  60.        only domain appended to the partial hostname, for example,
  61.  
  62.  
  63.  
  64.                         February 16, 1994                       1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. HOSTNAME(7)                                           HOSTNAME(7)
  71.  
  72.  
  73.        ``_l_i_t_h_i_u_m'',  making _l_i_t_h_i_u_m_._C_S_._B_e_r_k_e_l_e_y_._E_D_U the only name
  74.        to be tried using the search list.
  75.  
  76.        If the search option is used in  _/_e_t_c_/_r_e_s_o_l_v_._c_o_n_f  or  the
  77.        environment  variable, ``LOCALDOMAIN'' is set by the user,
  78.        then the search list will include what  is  set  by  these
  79.        methods. For example, if the ``_s_e_a_r_c_h'' option contained
  80.             _C_S_._B_e_r_k_e_l_e_y_._E_D_U _C_C_h_e_m_._B_e_r_k_e_l_e_y_._E_D_U _B_e_r_k_e_l_e_y_._E_D_U
  81.        then  the  partial  hostname  (e.g.,  ``_l_i_t_h_i_u_m'') will be
  82.        tried with each domainname appended  (in  the  same  order
  83.        specified).   The  resulting hostnames that would be tried
  84.        are:
  85.             _l_i_t_h_i_u_m_._C_S_._B_e_r_k_e_l_e_y_._E_D_U
  86.             _l_i_t_h_i_u_m_._C_C_h_e_m_._B_e_r_k_e_l_e_y_._E_D_U
  87.             _l_i_t_h_i_u_m_._B_e_r_k_e_l_e_y_._E_D_U
  88.  
  89.        The environment  variable  ``LOCALDOMAIN''  overrides  the
  90.        ``_s_e_a_r_c_h''  and ``_d_o_m_a_i_n'' options, and if both search and
  91.        domain options are present in the  resolver  configuration
  92.        file,   then  only  the  last  one  listed  is  used  (see
  93.        _r_e_s_o_l_v_e_r(5)).
  94.  
  95.        If the name was not previously tried ``as is''  (i.e.,  it
  96.        fell  below  the  ``_n_d_o_t_s'' threshold or did not contain a
  97.        dot), then the name as originally provided is attempted.
  98.  
  99. SSEEEE AALLSSOO
  100.        _g_e_t_h_o_s_t_b_y_n_a_m_e(3), _r_e_s_o_l_v_e_r(5), _m_a_i_l_a_d_d_r(7), _n_a_m_e_d(8)
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                         February 16, 1994                       2
  131.  
  132.  
  133.